perm filename NEW[UP,DOC] blob sn#049957 filedate 1973-06-20 generic text, type T, neo UTF8
*19 June 1973	WHOLINE TIME DAYTIME ESCAPE X ESCAPE Q	ME

A  new wholine,    new  TIME and  DAYTIME  commands, two  new  ESCAPE
commands and some new TTY monitor commands are up.

------

The new wholine  contains one new time  on the user line;  this time,
called XTIME and  followed on the wholine by an X, is the incremental
run time for the  given job since  the last teletype interaction  and
is shown in  hour, minutes, seconds and ticks.   The number after the
single  quote is ticks.  The single quote  itself is a right quote if
automatic  resetting  of  XTIME  is  enabled  and  a  left  quote  if
automatic resetting is inhibited; see [BRK] X below.

The XTIME is reset whenever the job comes  out of teletype input wait
and  whenever the  job is caused  to run  by a monitor  command other
than CONTINUE.   Thus the RUN, GET,   SAVE, SSAVE,  CORE 0,   FINISH,
START,  REENTER, DDT and all  the RPG monitor commands cause XTIME to
be  reset; and if the  job goes into IOWQ waiting  for input from the
teletype, then the  XTIME will be reset  when the job is  awakened by
teletype input.   However, note that if you have  typed ahead and the
job reads characters from the  teletype without having to wait,  then
your XTIME  will NOT be  reset.  (Monitor  commands that run  the job
will reset XTIME whether or not you have typed ahead.)

------

In order to allow flexible use of this  new icremental run time, some
new  ESCAPE keyboard  commands have  been added  along with  some new
monitor commands.

[BRK]  X inhibits  automatic  resetting of  your  XTIME.   Thus  this
allows your XTIME  to continue accumulating indefinitely.  It will no
longer be  reset  by coming  out  of tty  input  wait or  by  monitor
commands that run the program.

[ESC] X undoes  the effect of [BRK]  X, thus causing XTIME  to resume
being reset at the normal times.

Note that  neither  [ESC] X  nor [BRK]  X  causes any  change in  the
current XTIME.

[ESC] 1 X causes  your XTIME to be reset and  then inhibits automatic
resetting of XTIME.

[BRK] 1  X causes your  XTIME to be  set to your  total run  time and
then inhibits automatic resetting of XTIME.

------

Four new monitor commands have been added to  allow users who are not
on displays to get the effects of the above ESCAPE commands.

TTY UPDATE  does  the same  thing as  [ESC] X,  ie, enables automatic
resetting of your XTIME.

TTY NO UPDATE does the same thing as  [BRK] X, ie, inhibits automatic
resetting of your XTIME.

TTY TIME does the same  thing as [ESC] 1 X, ie, resets your XTIME and
then inhibits automatic resetting.

TTY NO TIME does the same thing as [BRK] 1  X, ie, sets your XTIME to
your total run time and then inhibits automatic resetting.

------

The  TIME command  has  been  modified  to print  out  five  labelled
quantities.   (TIME  still takes  an  optional job  number argument.)
Four of  these  are  times,  which are  printed  in  hours,  minutes,
seconds and ticks (the number after the single quote is ticks).

TOTAL is the total run time for the specified job.

INCREMENT is the old  incremental run time that the  TIME command has
always  printed and reset.   When you  request the TIME  for your own
job, this time is reset (like it always has been).  When  you request
the TIME for  another job, you do NOT cause  his incremental run time
to be reset.

XINCREMENT is the new  XTIME which is explained above.   The XTIME is
not changed at all by the TIME command.

WAIT is  the time the  job has  spent waiting for  the system.   This
includes  actual time running as  well as time waiting  to be run and
time waiting for disk  I/O, etc, but does  not include time spent  in
IOWQ waiting for  teletype input, nor time in STOPQ,  NULLQ or INTWQ.
This time also appears on the wholine with the label W.

KCS is the total number of kilo-core-seconds  you have used since you
logged in.   This number is incremented by your  core size (in K) for
every second of runtime.

------

The DAYTIME command  now takes an  optional job number  argument, eg,
"DAYTIM 22".  If the job number  is zero (eg, "DA  0"), then your own
job number is  used. If there  is an argument,  then three times  are
printed:  the time  of  login  of the  specified  job,  the time  the
specified  job  was last  run,  and the  current time.    The DAYTIME
command with no argument does the same thing it used  to do, ie, give
you the day, date and time.

------

[ESC] Q  now gives you  the wholine  for the next  job with the  same
programmer  name as the job  on your current wholine,  or as your own
job if you have no wholine up.

[BRK] Q does  the same thing as [ESC]  Q except that it  searches the
job table backwards.